home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 3
/
Cream of the Crop 3.iso
/
comm
/
voxel101.zip
/
VOIXEL.DOC
< prev
next >
Wrap
Text File
|
1994-02-06
|
53KB
|
2,747 lines
VoiXEL 1.01
Feb 6, 1994
===========================================================================
Contents
1 Introduction 2
1.1 What is VoiXEL ..................................... 2
1.2 Shareware Information .............................. 3
1.3 Summary of Features ................................ 4
1.4 System Requirements ................................ 5
1.5 Known Bugs ......................................... 5
1.6 Acknowledgements ................................... 5
2 Installation 5
2.1 Installing VoiXEL .................................. 5
3 The Workbench Interface 6
3.1 VoiXEL Tooltypes ................................... 6
3.2 VoiXELandGPFax ..................................... 6
3.3 VoiXEL ............................................. 8
4 Operating from the Shell 9
4.1 VoiXEL arguments ................................... 9
5 VoiXEL Userguide .......................................... 10
5.1 Manual Play ........................................ 10
5.2 Manual Record ...................................... 10
5.3 Record Conversation ................................ 10
5.4 Silence Level/Time ................................. 11
5.5 Compressions ....................................... 11
5.6 I/O Devices ........................................ 11
5.7 ZyXEL Voice Conversion ............................. 11
5.8 Answer Call/Fax/Data ............................... 12
5.9 Load & Save Settings ............................... 12
5.10 Answermachine ...................................... 12
5.11 Loglist ............................................ 13
5.12 Answer Option Settings ............................. 13
5.12.1 Fax & Data Scripts ............................... 13
5.12.2 Ring settings .................................... 13
5.12.3 Call Delivery .................................... 13
5.13 Remote Option Settings ............................. 14
5.13.1 Password ......................................... 14
5.13.2 Userdefined DTMF-keys ............................ 14
5.14 Remote Mode ........................................ 15
5.15 Remote Functions ................................... 15
6 Arexx-port 18
A Configuration Specifics 19
A.1 Serial Settings .................................... 19
A.2 OwnDevUnit.device ................................. 19
B Integration with other software 20
B.1 GPFax .............................................. 20
B.2 AmigaFax ........................................... 20
B.3 UUCP ............................................... 20
B.4 BBS Systems ........................................ 20
B.5 Term ............................................... 20
C Registration 22
C.1 How To Registrate VoiXEL ........................... 22
C.2 Registration Form .................................. 23
Chapter 1 Introduction
===========
1.1 What is VoiXEL?
VoiXEL is a program which uses the voice features in the ZyXEL1496-series
modem. The main purpose with VoiXEL is to use the ZyXEL-modem as an
answermachine. The answermachine is fully remotecontrolled so you can
listen to all incoming voice calls from another telephone.
1.2 Shareware Information
The Demoversion of VoiXEL is Shareware - it isn't free, and
all rights are reserved. You are not allowed to sell this
program, and you may only copy it for non-commercial purposes.
If you like (or use) VoiXEL, please registrate you as a user
of VoiXEL. You will then automatically receive a registered
version. Read more about the registrated version in this
documentation.
Any change to the executable or documentation is prohibited.
You may not modify, disassemble or decompile this program.
If you want to distribute VoiXEL, the program must be in its
original archive format, including all documentation files,
icons and scriptfiles.
The registered versions of VoiXEL are commercial and strictly
personal to the person who has registered VoiXEL. They are
not shareware and must not be spread or copied to other persons.
Persons who break these rules will be held responsible for the
economical damage they cause by spreading the registered versions.
Any contravention of this agreement, will cause that I have to stop
the development of VoiXEL.
1.3 Summary of Features
* GUI-interface
* Possibility to iconify VoiXEL and run it as a background task.
* OwnDevUnit.device support. VoiXEL releases the serial port if
any other task wants to use it.
* Localized in different languages. (English, German, Swedish)
* VoiXEL allows you to use the ZyXEL-modem as an answermachine. The
answermachine is fully remotecontrolled so you can listen at all
incoming voice calls from another telephone.
* VoiXEL starts a FAX-program if a FAX call was detected.
* VoiXEL starts a BBS-program or something else if the caller wants to
Up-/Download files with another modem.
* You can set a phonenumber where you actually are for the moment. If
VoiXEL receives a message it will automatically call this number and
deliver the message.
* A password is required to enter the remote functions.
* User-defined DTMF-keys in remote mode.
* Convert ADPCM files to IFF files.
* Convert IFF files (any sample frequence) to ADPCM2 or ADPCM3.
* Manual record from Phoneline or External microphone.
* Manual play to Amigaspeaker, Phoneline or Internal speaker.
If you play a ZyXEL file to Amigaspeaker, you don't have to convert it
to an IFF file. This is a nice feature when playing a 1Mb ZyXEL file...
* All compression methods are used. (CELP, ADPCM2, ADPCM3, ADPCM2 with
SYNC, ADPCM3 with SYNC)
* Possibility to answer the first incoming call after 4 RING-signals, next
call after 2 signals. Otherwise you could set it from 1 to 20 signals.
* All incoming calls are displayed in a Loglist.
Some information about the calls are displayed here, such as Date,
calltype, length and callernumber (if Fax-type).
You can very easy double-click to listen at a voicecall or viewing
an incoming fax.
* The demoversion doesn't include all functions such as:
The loglist is limited to 2 incoming calls. If the loglist is full
VoiXEL will play the outgoing message and then hangup.
* The registrated version includes all implemented functions and:
The Loglist is limited to maximum 200 incoming calls.
1.4 System Requirements
Computer: Amiga 500/600/1000/1200/2000/3000/4000
AmigaDOS 2.0 and over. (AmigaDOS 2.1 for localization.)
Harddisk is recommended.
Modem: ZyXEL 1496, 1496E(+), 1496R, 1496S(+)
ZyXEL ROM 5.04a++
Upgrade your ROM to 6.10a for better DTMF-detection
and if you want to use ADPCM2/3 with syncpulses.
VoiXEL isn't tested with ROM 6.11a yet, but it should work.
Software:
asl.library
OwnDevUnit.device (Recommended, but not required)
VoiXEL is mainly tested on:
A4000/040 / 8Mb RAM / 235Mb HD
Kickstart 3.0
ZyXEL 1496 E/E+ ROM6.10a
but also
A2000/000 512Kb Chip / 2 Mb Fast / 100Mb HD
Kickstart 2.04
ZyXEL 1496 E/E+ ROM6.10a
There are some problem to play ADPCM3 files yet, but if you have ZyXEL
ROM 6.10 or higher you could use ADPCM3 with sync-pulses. If the ZyXEL
modem loose any voice data during play, it will be corrected when next
sync-pulse is received.
VoiXEL is mainly tested on A4000/040 the last months. I hope there
won't be any bigger problems with slower machines. Use ADPCM2 if you
have problem with the playing. ADPCM3 is quiet reliably on my A4000
but I know it's not perfect.
1.5 Known Bugs
VoiXEL can't iconify if workbench isn't running.
1.6 Acknowledgments
I would like to thank all of you in my VoiXEL maillist who have sent me
bug-reports and comments. Your help was very valuable during the
development.
I would also thank:
Wolfgang Brodowski (Germany) for the german translation.
Ekkehard Br|ggemann (Germany) for the icon 'VoiXEL.info'
Mariah Carey for here entertainment during all compilations ;-)
Al Villarica
Mikko Hiltunen
Michael Krauss
McOrmond
and all other who helped me.
Chapter 2 Installation
===========
2.1 Installing VoiXEL
1. Assign the path VoiXEL: to your directory where you keep VoiXEL. You
can do this by adding this line to your s:User-Startup
Assign VoiXEL: Work:VoiXEL
2. The stack size MUST be 16384 bytes or bigger. When you start VoiXEL
from Workbench the icon should set the stack to 16384 bytes. If you
run VoiXEL from an AREXX-scripts such as 'VoiXELandGPFax' you must
edit your s:Startup-Sequence and add the line
Stack 20000
3. Copy the localization catalogs to your Locale:catalogs directory. (If
you want to use Swedish or German language) Just open a CLI window and
type:
Copy VoiXEL:Catalogs/svenska/VoiXEL.catalog Locale:Catalogs/svenska
or
Copy VoiXEL:Catalogs/deutsch/VoiXEL.catalog Locale:Catalogs/deutsch
4. Make sure that you have your registration file 'VoiXEL.key' in your
VoiXEL: directory. (Not necessary in Demo version)
5. If you want to integrate VoiXEL with GPFax you'll have to change some
settings in GPFax. Read more about this in
'Integration with other software'
Once configured, VoiXEL may be operated either from a Shell or CLI
(Command Line Interface), or from the Workbench.
Chapter 3 The Workbench Interface
===========
3.1 VoiXELandGPFax
This is a script which starts GPFax as a background task. After GPFax
is running, VoiXEL will start and open the mainwindow.
3.2 VoiXEL
When you double-click on the `VoiXEL' icon, VoiXEL mainwindow will open.
The first time you start VoiXEL it will create a settings-file
named 'VoiXEL:VoiXEL.settings'. VoiXEL will also create a loglist for
incoming messages named 'VoiXEL:VoiXEL.log'.
Every loglist requires a prefix for incoming voicecalls. After this is
chosen VoiXEL is initiated. If you have the registrated version, VoiXEL
will try to read the keyfile 'VoiXEL:VoiXEL.key'. If VoiXEL can't find
it or if it isn't a valid keyfile, you won't be able to do anything
with VoiXEL.
The gadget functions in VoiXEL mainwindow are:
'I/O Device Play' Select the I/O device when playing a ZyXEL voice file
'I/O Device Rec' Select the I/O device when recording
'Compression' Select the compression when recording
'Play Voice' Play the workfile
'Record Voice' Record a ZyXEL voice file
'Phone Answer' Open the Phone Answer window
'Answer Voice' Answer a call at once. (call added to the loglist)
'Answer Fax' Execute the Fax script. (call added to the loglist)
'Answer Data' Execute the Data script. (call added to the loglist)
'Record Conv.' Record a conversation. (call added to the loglist)
'Play/Rec File' Set the Play/Record file and outgoing message
'Silence level' Set the silence level when recording
'Silence time' Set the silence time when recording
'Max Record Time' Set maximum record length
The menu functions are:
'Project'
'Iconify' Iconify VoiXEL. VoiXEL will still answer calls if
the answermachine is turned on.
'About' Show some information about VoiXEL
'Quit' Quit VoiXEL
'Settings'
'Load Settings' Load a settings file
'Save Settings' Save a settings file
'Close Serial Port' Close the serial port and unlock it.
'Convert'
'ADPCM TO IFF' Convert from ADPCM2/3 to IFF
'IFF TO ADPCM2' Convert from IFF to ADPCM2
'IFF TO ADPCM3' Convert from IFF to ADPCM3
'Play'
'Realtime play' Convert the ZyXEL file to IFF while playing
file to Amiga speaker
'Create .IFF file' Create .IFF files before playing to Amiga speaker
'Load all at once' Load whole IFF file into RAM memory. This could
be useful if you have a VERY slow Amiga and
use DF0:
'Set temporary file' Set the temporary file when converting a ZyXEL
file to a IFF file.
'Record'
'Autostop when Silence' Stop record when silence is detected
'Save to RAM: first' Speed up recording by record to RAM: first
'Answer'
'Save Short Calls' Save all incoming calls even if they are 'empty'
in the loglist.
A short call is defined as "shorter than
'silence time' + 1 second"
'Beep before record' Send a Beep tone after playing outgoing message
'Enable Fax' Enable Fax script
'Enable Data' Enable Data script
The gadget functions in VoiXEL Phone Answer window are:
'Loglist' Loglist with all incoming calls.
Double-click if you want to play a voice call or
view a fax document.
'Play Marked Call' Play marked call in the loglist.
'Delete Marked Call' Delete marked call in the loglist. This means that
the ZyXEL voice file is deleted from disk.
'Delete All Calls' Delete all calls in the loglist.
'Archive Marked Call' Archive marked call in the loglist. This means that
the ZyXEL voice file is removed from the loglist and
renamed on the disk. You will be able to replay
the file if you want manually.
'Archive All Calls' Archive all calls in the loglist.
'Logfile' Set logfile to use and show in the loglist.
'Infile (prefix)' The prefix for incoming voice calls. This file-prefix
connected to the logfile and can't be changed more
than once when you create a logfile.
'Outgoing Message' Same file as 'Play/Rec file'. This file is played
just after VoiXEL makes onhook. The file is always
played to the phoneline.
'Set Outgoing Mess.' This button will set the "Outgoing Message" to
the "Play/Rec File".
'I/O device play' Used device when playing a zyxel voice file
'Change Remote Options' Open the Remote Options window
'Change Answer Options' Open the Answer Options window
The gadget functions in VoiXEL Remote Options window are:
'Enable Remote' Enable the remote mode, so a password could
be entered from an incoming call.
'Password' Password to enter remote mode.
Must be a 1-6 digit password. (Ex. 1, 994, 123456)
'Button function:' User-defined remote functions for all DTMF-Keys
The cycle gadget shows the function for the
Active key.
The gadget functions in VoiXEL Answer Options window are:
'Enable Delivery' Enable the deliver function. If enabled, you
must choose a number and message file too.
'Deliver number' Number to dial when there are a new incoming
message to deliver.
The number may be max 20 digits.
'Deliver message' Message file to play after dialing the number.
'Ring Volume' Set the ring volume when phone answer is turned ON.
'Rings for answer' Set number of RINGING's for answer.
'4-2 Signal Answer' Answer first call after 4 RINGING's,
next after 2 RINGING's.
'DTMF-Key To Start DataScript'
DTMF key which starts the Data-script. This key could
be pressed while playing the outgoing message or
recording the incoming message. The key can only
be '#' or '*' so it won't collide with the password.
'Fax script' The script which should be executed when a FAX
call is detected.
'Data script' The script which should be executed when a DATA
call is detected.
'Enable Fax script' Execute the Fax script when FAX tone is detected.
'Enable Data script' Execute the Data script when caller presses the
DTMF-Key described above.
3.3 VoiXEL Tooltypes
Following tooltypes can be defined your VoiXEL.info:
DEVICE=any.device Open any.device
(default: serial.device)
UNIT=1 Open unit 1
(default: 0)
PLAYPRIORITY=0 Set VoiXEL task priority to 0 while playing
a file to your ZyXEL modem. (-128 <-> 127)
(default: 25)
SETTINGS=test.settings Read 'test.settings'
(default: VoiXEL:VoiXEL.settings)
ANSWERON Start answermachine at once after startup.
(default: Don't start at once)
NOODU Don't open or use OwnDevUnit.device.
(default: Open and use OwnDevUnit.device)
DIALTYPE TONE or PULSE
(default: TONE)
NOWINDOWUPDATE Don't update windows while playing a file.
(default: Always update)
QUIET Run VoiXEL as a background task. Don't open
any windows.
(default: Open windows)
Chapter 4 Starting from the Shell
===========
4.1 VoiXEL arguments
VoiXEL could easily be started with only 'VoiXEL', but you could list
all commandline arguments with 'VoiXEL ?'. You should receive:
>VoiXEL ?
DEVICE/K,UNIT/K/N,SETTINGS/K,ANSWERON/S,NOWINDOWUPDATE/S,PLAYPRIORITY/K/N,
DIALTYPE/K,NOODU/S,QUIET/S:
DEVICE any.device Open any.device
(default: serial.device)
UNIT 1 Open unit 1
(default: 0)
PLAYPRIORITY 0 Set VoiXEL task priority to 0 while playing
a file to your ZyXEL modem. (-128 <-> 127)
(default: 25)
SETTINGS test.settings Open 'test.settings'
(default: VoiXEL:VoiXEL.settings)
ANSWERON Start answermachine at once after startup.
(default: Don't start at once)
NOODU Don't open or use OwnDevUnit.device.
(default: Open and use OwnDevUnit.device)
DIALTYPE TONE or PULSE
(default: TONE)
NOWINDOWUPDATE Don't update windows while playing a file.
(default: Always update)
QUIET Run VoiXEL as a background task. Iconify
at once.
BUG: VoiXEL can't add an application object
to the screen if workbench isn't running.
(default: Open windows)
Chapter 5 VoiXEL Userguide
===========
5.1 Manual Play
When you want to play a ZyXEL voice file manually, you have to set up
the following things:
Choose a filename in gadget 'Play/Record File'
Choose an 'I/O Device (play)'
If you choose 'Amiga Speaker' you could change some settings in the
menu too.
'Realtime Play' Convert the ZyXEL voice file while playing. If this
isn't used, VoiXEL will convert the file to a
temporary .IFF file first. This options should only
be used if you have 68030/68040 processor.
'Create .IFF File' Instead of creating a temporary .IFF file, VoiXEL
will create a .IFF file which not is deleted.
Ex. If you play test.VXL, VoiXEL creates test.IFF
in the same library. Next time you play this file,
VoiXEL will read the .IFF file instead of converting
the .VXL file.
'Load All At Once' An option which will load the .IFF file into
memory at once. Could be used if you have saved the
.IFF file on DF0: or any other slow device.
'Set Temporary File' Choose the temporary file name which is used if
you don't choose either 'Realtime Play' or
'Create .IFF File'.
Press the gadget named 'Play' to begin the playing.
5.2 Manual Record
Select a filename in gadget 'Play/Record File'
Select an 'I/O Device (rec)'
Set the 'Silence Level' and 'Silence Time'
Set the 'Maximum Record Time'
Set 'Autostop When Silence' if wanted
Press the gadget named 'Record to begin the recording.
5.3 Record Conversation
If you want to record a conversation on the phone line you could use
'Record Conversation'. Remember that your ZyXEL modem have to listen
on the phoneline, not disconnect it. The have to connect your modem
like this:
Telecominterface ----------------- (Line)Modem(Phone)
| |
Telephone Amiga
--------------------
If you connect them like this:
Telecominterface --- (Line)Modem(Phone) --- Telephone
|
Amiga
your ZyXEL will disconnect your telephone when it begins to record !!!
--------------------
Just press 'Record Conversation', VoiXEL will choose the filename
automatically and to 'I/O Device' will be 'Telco Line'. If you
press 'STOP', silence is detected (if selected) or if the conversation
is longer than 1000 seconds, VoiXEL will stop recording and the call
will be added to the Loglist.
5.4 Silence Level/Time
It's very important to set the Silence Level and Time to correct values
before recording. When you use VoiXEL as an answermachine, Silence Level
should be set to 14-18. If it's to low, VoiXEL won't interrupt the
recording after hangup. The recording will instead be interrupted after
the 'Max Record Time' has expired.
If the Silence Level is to high, VoiXEL will interrupt the recording when
the caller is talking with normal voice strength.
The Silence Time should normally be set to ~30 10th of a second.
5.5 Compressions
You can record a ZyXEL voice file in five different compression methods.
If you have a ZyXEL1496x+ with ROM6.10++ you can use all compressions.
CELP compression can only be used if you have a PLUS model.
ADPCM2/3 with SYNC-pulses can only be used if you have ROM 6.10 or newer.
5.6 I/O Devices
When you want to record a ZyXEL voice file manually with the 'Record'
gadget, you can choose either 'Telco Line' or 'External Mic.'.
You can connect your phone to your ZyXEL modem some different ways.
First of all you could connect a phone handset to the RJ11C line jack.
This will give you a better sound quality. Choose 'External mic' as source.
External Mic is the same as 'phone line', but the signal is amplified.
Use the EARPHONE as microphone!
If you can't unplug the handset, just use your telephone connected to the
line. You could for example dial one number, just to make the line quiet,
and then record. Try 'External mic.', 'Phone line', talk to phone's
earphone or microphone to get the best sound quality.
-------------------------------------- (from ZyXEL documentation)
If you have a telephone set with a handset that has a cable with a RJ11C
connector plugged into the phone set main body, you can unplug the handset
and plug it into the modem Line Jack and then use the handset as both a
microphone and speaker.
The central two wires in the Line Jack are the signal wires to be connected
to the phone company. If you connect the handset to this Line Jack, normally
the earphone in the handset will be connected to the modem's two-wire line
terminals. You can hear the voice when the modem is in playback mode and you
can speak to the earphone (remember "earphone") in recording. In recording
mode, the earphone is used as a microphone.
CAUTION: Never plug the handset into the modem's Phone Jack because it will
be connected to the phone line when modem is on-hook and it will be damaged
by the phone line's DC voltage and current.
-------------------------------------- (from ZyXEL documentation)
When you want to play a ZyXEL voice file, you could play it either to the
phoneline, internal speaker or Amiga speaker.
If you choose the Amiga speaker you won't be able to play CELP files,
because VoiXEL must convert the ZyXEL voice files into IFF files before
playing them. I haven't made a good CELP decoder yet, but perhaps I will
include it later.
If you have an Amiga 3000/4000 I recommend you to select the 'Realtime Play'
from the menu. This options will make it possible to convert the ZyXEL file
to IFF at the same time as VoiXEL plays it to the Amiga speaker. There will
be no conversion time before playing then.
5.7 ZyXEL Voice Conversion
From the menu you can start a conversion from ADPCM->IFF, IFF->ADPCM2 or
IFF->ADPCM3.
Conversion from ADPCM->IFF will create an IFF file with sample rate
9600 bytes per second.
Conversion from IFF->ADPCM doesn't require any special sample rate in
the IFF file. The converted ADPCM file will seem to look like the
IFF file. If the sample rate is higher then 9600 bytes per second, you
will loose some data so the voice quality becomes worse. If the "STOP"
gadget is pressed when converting a file, the conversion is aborted.
5.8 Answer Call/Fax/Data
In the mainwindow there are three buttons marked 'Answer Fax', 'Answer Data'
and 'Answer Call'.
'Answer Fax' and 'Answer Data' is used when you manually want to start the
Fax or Data AREXX scripts. The script should start a program and then
return some information to the loglist. You don't have to do that if you
don't have any information. After the script has returned, VoiXEL restores
the serial port and makes the update to the loglist. If VoiXEL can't restore
the serial port, it won't be able to use it any more. You must close the
serial.device and reopen it in that case. This could happen if the Fax-
or Data-program leaves your ZyXEL modem in a unknown mode.
It has happened a couple of times if you receive a Faxdocument with GPFax
and abort it with the Closewindow gadget at once. It won't happen if you
let GPFax run without pressing any Abort or Closewindow.
'Answer Call' will make onhook and play the outgoing message to the
Phone Line and then record an incoming ZyXEL voice file. The call will
automatically be added to the loglist.
The incoming call will be handled in exactly same way as if the answer-
machine is turned ON. Read about Answermachine for more information.
5.9 Load & Save Settings
Load and Save Settings are selected from the menus. VoiXEL will always
read 'VoiXEL:VoiXEL.settings' during startup if you don't select a new
with the 'SETTINGS' option. If the file doesn't exist when you start
VoiXEL, the file will be created and saved with the default settings.
All settings are saved, such as
Compression (Play/Rec)
I/O Devices (Play/Rec)
Workfile (Outgoing Message)
Silence Level/Time
Max Record Length
Autostop When Silence
Save To RAM: First
Beep Before Answer
Realtime Play/Create .IFF/Load All At Once
Enable Remote Functions/Remote Password
Remote DTMF-Keyfunctions
Logfile-Name
Enable Delivery/Deliver Number/Deliver Message
DTMF-Key For Data Script
Fax Enable/Fax Script
Data Enable/Data Script
Rings For Answer / 4-2 Answer / Volume
5.10 Answermachine
This is the main purpose with VoiXEL. Everything which controls the
way to handle the call is coded into VoiXEL mainprogram. I don't want
to let an AREXX script handle everything during a call.
I will add the possibility to control everything from an AREXX script
later, but this could take some more time to implement. The AREXX
interface is nearly complete to do this already, but there must must be
more error checks and options to all functions.
It could be used for those who want to ask the caller something, wait
for a DTMF-Key, save the result and so on... (You could perhaps ask them
about their waist or shoe size :-)
The Fax and Data call are handled with AREXX scripts. I made this to make
it easier to integrate it with other softwares.
If you want to use VoiXEL with other programs, I'm sure you could rewrite
the AREXX scripts so they work for your purposes. Please tell me about
which program you use together with VoiXEL (and your new AREXX script)
5.11 Loglist
All incoming voice calls are added to the loglist. The information in it is:
Date & Time Standard date format. (MMM DD hh:mm:ss)
Call Type Could be D,F or V (Data, Fax, Voice)
Seconds The incoming file length in seconds
CallerNumber The number from where the call was received.
This is only set from the Fax Script. GPFax receives
a number which could be inserted here.
You can mark a call by just clicking it. When a call is marked, you can
choose a function such as 'Play Marked Call' etc... If you double-click
a voice call, VoiXEL will automatically play the voice file.
If you double-click a fax call, VoiXEL executes the AREXX script
'VoiXEL:VoiXELviewfax.rexx'. This script only works if your fax call
was received with GPFax.
The reason to why I haven't implemented the real CallerID, is that I
don't have this service in Sweden. I don't know to handle it yet, so
don't be angry on me... We will get another CallerID quiet soon, but
ZyXEL won't make new ROM-images for this standard.
5.12 Answer Option Settings
5.12.1 Fax & Data Scripts
You could select another Fax- or Data-script if you have any other scripts.
The scripts are executed with 'RX'. Check so you have 'RX' in a correct
path.
5.12.2 Ring settings
There are settings so you could adjust number of 'Rings For Answer'. This
value can be from 1 to 20. If you choose '4-2 Signal Answer', VoiXEL will
disable 'Rings For Answer' slider, and answer the first call in the
loglist after 4 signals, next call will be answered after 2 signals.
The 'Ring Volume' is used so you could adjust ZyXEL's ring volume.
5.12.3 Call Delivery
Call Delivery is a nice feature in VoiXEL. If you are going to stay away
from home, and know your friends phone number, you could enter the number
in the 'Deliver Number' gadget. Record a ZyXEL voice file which could look
like this:
'This is Mag's answermachine calling. I have a message to deliver to Mag.
Please enter password to enter remote mode.'
and enter the file name in the string gadget 'Deliver Message'. Enable the
the Deliver function and start the answermachine. If somebody calls you,
VoiXEL will wait for 7 seconds and then dial the Deliver Number. If
you pick up the phone, VoiXEL plays the 'Deliver Message' and waits for
the password. After a correct password is entered, you could listen to
the incoming voicecall(s).
If VoiXEL receives BUSY, NO DIALTONE, NO ANSWER or if something else went
wrong, VoiXEL will make 3 more retries.
The call delivery will abort if:
An AREXX message is received.
An OwnDevUnit signal is received.
Anything is received from the modem (ex. RING)
You stop the answermachine.
For some reason I have problem with my new 6.10a ROM. When I call a
number, the zyxelmodem thinks that the other side has gone off-hook
after one signal even if it hasn't. (My 5.04a ROM works perfect...)
This will cause that the outgoing message is played even if nobody
answer your call. I think there are a timer that should be adjusted.
My ZyXEL modem thinks that it's too long silence between the RING
signals. I haven't found anyone who know if it's possible to adjust
this with a software register or somewhat...
5.13 Remote Option Settings
5.13.1 Password
To enter the remote mode you must have a password. This password is set
in the 'Password' gadget. The password must contain 1-6 digits. If you
want to make it possible to enter the remote mode, then set 'Enable Remote'.
5.13.2 Userdefined DTMF-keys
The remote commands is user-defined in the 'Remote Options Window'. Every
DTMF key (0-9,*,#) may have one function.
How to change a remotekey function:
Just press (with the mouse) the key you want to define.
'Active' gadget will now show the button, and the cycle gadget shows
current function for the key.
Change the cycle gadget to the function you want.
The key is now defined.
Possible functions is:
Play All Calls
Play Marked Call
Previous Call
Next Call
Delete Marked Call
Archive Marked Call
Change Outgoing Message
Enable/Disable Delivery
Set Deliver Number
Change Deliver Message
Change Password
5.14 Remote Mode
If you have enabled the remote mode, you could enter the password from
a telephone with DTMF keys while either playing the outgoing message or
when you record the incoming voice. If you have "345" as password, VoiXEL
will check if you enter 3 followed by 4 and 5. This means that you could
enter "12345" as a matching password. I made this because it not a perfect
detection of DTMF-keys. If VoiXEL doesn't recognize the "4" for example,
you could try to reenter the password at once.
When you succeeded to enter the password, the play or record will be
interrupted, and you will hear 3 short beep tones.
VoiXEL is now waiting for your remote command. You have 30 seconds to press
any key.
When a DTMF key is pressed, VoiXEL will execute the remote function. After
the function has returned, you will hear 1 long beep tone and VoiXEL waits
for a new remote command.
The detection of the DTMF key will continue until the time has expired. It
won't abort if the caller hangs up or if silence is detected.
The beeps will be replaced with recorded zyxel files in later versions.
I'll do this as soon as possible.
5.15 Remote Functions
In all remote functions you will hear different beep tones as an answer
of the status or something else.
Normally is that:
3 short beep tone means 'ERROR'.
1 long beep tone means 'Remote Function Has Returned'
Play All Calls
==============
This function will play all incoming voice calls in the loglist,
beginning with the oldest one. Every call will be separated with 1
short beep tone.
If the call isn't a voice call, you will hear 1 long beep tone.
If the loglist is empty, you will hear 3 short beep tones.
Play Marked Call
================
This function will play the marked call in the loglist.
The last incoming call will always be marked from the beginning.
If the call isn't a voice call, you will hear 1 long beep tone.
If the loglist is empty, you will hear 3 short beep tones.
Previous Call
=============
This function will mark the previous (older) call.
If the loglist is empty or if there aren't no previous call, you will
hear 3 short beep tones.
You will begin to hear 1 long beep.
Then: If you hear 1 short beep, the last and oldest call is marked.
If you hear 2 short beeps, the second oldest call is marked.
etc...
You will as usual hear 1 long beep after the function has returned.
Next Call
=========
This function will mark the next (newer) call.
If the loglist is empty or if there aren't no next call, you will
hear 3 short beep tones.
You will begin to hear 1 long beep.
Then: If you hear 2 short beeps, the second oldest call is marked.
etc...
You will as usual hear 1 long beep after the function has returned.
Delete Marked Call
==================
This function will delete the marked call from the loglist and disk.
You have no possibility to listen at this call again..
If the loglist is empty, you will hear 3 short beep tones.
If the call is was deleted, you will hear 1 short beep tones.
Archive Marked Call
===================
This function will archive the marked call in the loglist. The call
is removed from the loglist and renamed on the disk.
You can listen at this call again manually.
If the loglist is empty, you will hear 3 short beep tones.
If the call is was archived, you will hear 1 short beep tones.
Change Outgoing Message
=======================
This function will record a new outgoing message with same file name
as before. The old file will be deleted.
When recording this message some special settings are used:
Maximum record length is set to 120 seconds.
Autostop when silence is enabled.
Silence Level is set to 17 decibel.
Silence Time is set to 3 seconds.
After you hear 3 short and 2 long beep tones, VoiXEL will record
until it detects silence. You must be very quiet after talking your
message.
When VoiXEL has recorded your new outgoing message it will as usual
beep 1 long tone and wait for new remote commands.
Enable/Disable Delivery
=======================
With this function you can toggle the Enable/Disable Delivery.
If you hear 3 short beep tones, you have Enabled the Delivery.
If you hear 1 short beep tone, you have Disabled the Delivery.
Set Deliver Number
==================
With this function you can change the Deliver Number.
You will now hear 2 short beeps and VoiXEL waits for you to enter the
new phonenumber.
You have 60 seconds to enter max. 20 digits.
Press '#' after the last digit.
You will now hear 2 short beeps again and VoiXEL waits for you to enter
the new phonenumber again.
You have 60 seconds to enter max. 20 digits.
Press '#' after the last digit.
If the two phonenumbers are exactly the same, you will hear 1 long beep
tone and the Deliver Number is changed.
If the two phonenumbers weren't the same, you will hear 3 short beep
tones and the Deliver Number is unchanged.
Change Deliver Message
======================
This function will record a new Deliver Message with same file name
as before. If no file was chosen before, VoiXEL chooses a default
filename. (VoiXEL:DeliverMessage.VXL)
When recording this message some special settings are used:
Maximum record length is set to 120 seconds.
Autostop when silence is enabled.
Silence Level is set to 17 decibel.
Silence Time is set to 3 seconds.
After you hear 3 short and 2 long beep tones, VoiXEL will record
until it detects silence. You must be very quiet after talking your
message.
When VoiXEL has recorded your new outgoing message it will as usual
beep 1 long tone and wait for new remote commands.
Change Password
===============
With this function you can change the Password.
You will now hear 2 short beeps and VoiXEL waits for you to enter the
new password.
You have 60 seconds to enter max. 6 digits.
Press '#' after the last digit.
You will now hear 2 short beeps again and VoiXEL waits for you to enter
the new password again.
You have 60 seconds to enter max. 6 digits.
Press '#' after the last digit.
If the two Passwords are exactly the same, you will hear 1 long beep
tone and the Password is changed.
If the two Password weren't the same, you will hear 3 short beep
tones and the Password is unchanged.
6 Arexx-port
I haven't included all AREXX-commands in this demoversion. The only
functions that you should use is described here and is only used
when you want to integrate VoiXEL with other programs. (Such as GPFax)
I couldn't decide what to do with the AREXX-port.
1.. I didn't want to write the answerroutine in AREXX, because I
wouldn't be able to control the serial port in an optimal way then.
2.. I had to use the AREXX interface when I'm returning values from
Fax or data scripts. It wouldn't be able to integrate VoiXEL with
other softwares if I didn't have an AREXX-port.
3.. The most important thing is that VoiXEL can run together with
any program.
Command Description
------------------------------------------------------------------
* Quit Quit VoiXEL at once.
* setVAR <variable> <string/num>
LENGTH Set call length in Loglist. (seconds)
CALLERNUMBER Set callernumber in loglist.
FILENAME Set filename connected to call. This filename
is used for finding Fax-documents or voice files.
RETURNCODE Return string from script. (not used yet)
--------------------------------------------------------------------
Here are some undocumented AREXX-commands, but please don't use them
yet. I know there are some (many) bugs left in them, and I will change
them when I have a better plan for the AREXX-port.
CloseSerial
OpenSerial <device> <unit>
getWorkfile |
setWorkfile |
PlayNoRestore | They use variable 'FILENAME' for input
Play | and output for the moment.
RecordNoRestore |
Record |
LoadSettings |
SaveSettings |
InitVoiceMode <NoDevice | PhoneLine | ExternalMic | InternalSpeaker>
RestoreVoiceMode
ReadKey <num> <timeout>
ReadKeyUntil <num> <timeout> <endchar>
SetAutoStop <ON | OFF>
SetBeep <ON | OFF>
SetCompression <CELP | ADPCM2 | ADPCM3>
SetIOPlay <AmigaSpeaker | PhoneLine | InternalSpeaker>
SetIORec <PhoneLine | ExternalMic>
SetRecordTime <value>
SetRingsForAnswer <value>
SetRingVolume <value>
SetSaveToRam <ON | OFF>
SetSilenceLevel <value>
SetSilenceTime <value>
SetSmartAnswer <ON | OFF>
Beep <length> <tone1> [<tone2>]
Appendix A
============
Configuration Specifics
A.1 Serial.device
The serial.device is opened in shared mode, 38400 Baud,8,N,1. Other programs
which is used for Data Calls such as getty should open the serial.device
with same parameters.
A.2 OwnDevUnit.device
OwnDevUnit.device is not required, but I recommend you to use it. If VoiXEL
is started and waits (iconified or not), VoiXEL will release the serial port
if any other program wants to use it. (Both program must use OwnDevUnit)
After a few seconds VoiXEL tries to lock the serial port again. VoiXEL is
hanging until the serial port is locked again. There are no way to quit
VoiXEL in this situation. If VoiXEL was waiting for an incoming call before
the interrupt, it will continue with this after locking the serial port.
This means that you don't have to quit VoiXEL if you start 'Term' for
example. When you quit 'Term', VoiXEL will lock the serial port and you
are able to use it again.
Appendix B
============
Integration with other software
B.1 GPFax
I recommend you to use GPFax together with VoiXEL if you want to use the
ability to receive fax calls. The fax scripts which is included, should
work without any problems if you use GPFax 2.30. I don't now if older
versions work, but I think so.
Remember to edit the settings in GPFax before using it. The InitString
must not contain '&F'. The '&F' restores the modem to factorysettings when
you start GPFax. It will also hangup the line and cause a flash or perhaps
you loose the connection with the incoming call.
The string could look like this:
AATE0V1X4&K3&C1&D2S0=0
You must also run GPFax in shared mode. If not, VoiXEL and GPFax can't use
the serial.device at the same time.
B.3 UUCP
VoiXEL can be used together with AmigaUUCP if you want. If the caller
starts the Datascript you could run the getty-like program to validate
a correct login on your computer.
Remember:
The Datascript is executed after VoiXEL has interrupted the play or record.
VoiXEL will wait until the script has returned, so you must be sure that
the script terminates after ONE logoff or lost connection.
You CAN'T use the original getty (V1.16.14), because this program will
hangup and wait for a new call. VoiXEL will hang here...
Agetty is a program made by Peter Simons and have the option so you could
make only ONE login and then exit.
B.4 BBS Systems
There should not be any problem to use VoiXEL with any other BBS systems.
The most important thing is that it must exit after one call. (See UUCP)
B.4 Term
(Term is copyrighted by Olaf Barthel)
I tried to ask people about simple BBS programs or a program which allows
upload and download. Actually I didn't get many answers, but I got one
suggestion from Bob Maple. He had made an easy AREXX script which waited
for an easy login and then allowed only upload and download. I changed it
a bit so I could integrate it with VoiXEL. For some reason I couldn't load
another settings file when I started Term, so I had save the changes to
the default 'term.prefs' instead. Some settings must be changed, such as:
Serial Settings: All settings must match VoiXEL's.
Baud Rate 38400 8N1
Handshaking CTS/RTS
Full Duplex
Break Length 250000
Shared Access
Modem Init String: May not be ATZ\r. I changed it to AT\r
The simple VoiXELminiBBS AREXX-script is untested, but I don't see any
problem there any more. The only thing I've tested is the initialization
so it will start up correct. I'm not very good in AREXX programming, so
my solution isn't the best... I know :-)
I hope that you've got an idea of how you can use it and make a better
script, or integrate VoiXEL with other BBS programs. If you know any
other easy BBS programs, please let me know. I would like to include
more AREXX-scripts (and better) for my next release.
VoiXELMiniBBS.rexx has a main menu which look something like this:
MiniBBS Main Menu
-----------------
U. Upload file
D. Download file
C. Change Directory
S. Show Directory (Dir)
L. List Directory (List)
G. Loggoff
Choose a command:
I think it's self-explaining how to use it, so I don't tell you any more..
Change it if you like and send me a better version.
===========================================================================
Appendix C
============
C.1 How To Registrate VoiXEL
If you use like VoiXEL, and would like to see new versions in the
future, please registrate you as a user of VoiXEL.
You will then automatically receive a registered version.
Fill in the registration form and send it to me. I prefer that you
send it to me via EMail. You must fill in the registration form
and answer all my questions. Your name will be installed in the
registrated version.
The registration fee is 110SEK or 22DM. (+40SEK for shipping)
If I could send your registrated version of VoiXEL via EMail to you,
there won't be any extra expenses for shipping. I won't accept any
checks or creditcards.
If you think VoiXEL is worth more, you could pay higher registration fee
or send me a gift (or two). (I need a bigger harddisk and 4-8Mb extra RAM
for my A4000/040 :)
I've spent much time on this project now, so I hope you understand that
I've made a registrated version now.
Send the registration fee to:
Account 1160 - 17 089 154 - 2
HandelsBanken Kristianstad, Sweden
or
send 110 SEK in an envelope together with the registration form.
It's probably much easier (and cheaper) for both of us.
AND send the registration form to:
Christian 'Mag' Magnusson
Gibraltargatan 84:519
412 79 Gothenbourg
Sweden
Email: d1mag@dtek.chalmers.se
C.2 Registration Form
First Name :
----------------------------------------------------
Name :
----------------------------------------------------
Address :
----------------------------------------------------
Country :
----------------------------------------------------
EMail address :
----------------------------------------------------
Hardware Config. :
----------------------------------------------------
Modem :
----------------------------------------------------
Where do you want me to send your registrated version of VoiXEL ?
(To Email-address in uuencoded format) / (To the address above)
Where did you find and hear about VoiXEL ?
--------------------------------------------------------------------------
--------------------------------------------------------------------------
Do you want to use VoiXEL in any other localization-language ?
(If yes... Do you want to help me with the translation ?)
--------------------------------------------------------------------------
--------------------------------------------------------------------------
Have you tried to integrate VoiXEL with other softwares ?
(Such as Fax programs, BBS's or something else)
--------------------------------------------------------------------------
--------------------------------------------------------------------------
Do you have any suggestions for my next release ?
--------------------------------------------------------------------------
--------------------------------------------------------------------------